YouAreNotCrazy v1.1.0
by BruceJames
https://brucejames.studio

------------------------------------------------------------------------
What is it?
------------------------------------------------------------------------

YouAreNotCrazy is a free recording latency correction utility. It
measures the systematic timing offset between your playing and the DAW
grid, then tells you exactly what to set your recording latency to.

This is not about your audio interface latency - that's fixed hardware.
This is about YOU. If you always play 12ms late (or early), that's a
consistent offset that your DAW can compensate for automatically. YANC
finds that number.

------------------------------------------------------------------------
How to use it
------------------------------------------------------------------------

1. Insert YouAreNotCrazy on any audio or MIDI track.
2. Press play in your DAW with a click track running.
3. Play along to the click - at least 8 hits.
4. The plugin will display your average timing offset and tell you
   exactly what to set your DAW's recording latency/offset to.

Detection modes:
  Audio  - detects transients in the incoming audio signal
  MIDI   - detects Note On events
  Both   - uses MIDI if present, falls back to audio (default)

Grid - the note value you are playing. Hits are measured against the
   nearest grid line, so if you play 8th or 16th notes you must set this
   to match, or every off-beat hit is scored as a large error. Changing
   the grid clears the current measurements.

Threshold slider - sets the audio onset detection sensitivity.
   Lower values detect quieter transients. Raise it if you're getting
   false triggers from bleed or room noise.

Reset - clears all measurements and starts fresh.

Update available - an amber button appears in the control strip when a
   newer version has been released. Click it to open brucejames.studio.

Usage mode - tell the plugin how it's being used:
  Recording  - measures how early/late you play and tells you what to
               set your DAW's recording latency to (default).
  On a Track - use this when the plugin is inserted on an already
               recorded track instead. It tells you how many
               milliseconds/samples to shift the track left or right
               to line it up with the grid.

Capture slots - save up to 6 named setups (e.g. "Desk", "From couch")
   so you can switch between rooms/instruments without re-tuning the
   threshold and mode every time. Each slot also stores the reading that
   was on screen when you saved it, and shows it underneath the name, so
   the row doubles as a comparison between setups.
   Click an empty slot to save your current settings under a name; click
   a saved slot to load it; click the loaded (highlighted) slot again to
   overwrite it with your current settings and reading. Right-click any
   slot for rename or clear. Captures are saved to your user profile and
   available in every project.

The reading - after 8 hits the plugin shows its recommendation along
   with a "+/-" figure. That figure is how well the AVERAGE is pinned
   down, not how tightly you play; it shrinks as you collect more hits.
   The recommendation is usable as soon as it appears, and "still
   settling" means it will keep tightening if you keep playing.

On the grid - once your average offset is stable and under 2ms, the
   status box turns green and the logo briefly flashes "YouAreCrazy"
   to celebrate.

------------------------------------------------------------------------
System Requirements
------------------------------------------------------------------------

Windows:
  - Windows 10 or later (64-bit)
  - VST3, CLAP, or AAX (Pro Tools) compatible DAW

macOS:
  - macOS 10.13 or later
  - VST3, AU, CLAP, or AAX (Pro Tools) compatible DAW
  - Universal Binary (Apple Silicon + Intel)

Linux:
  - 64-bit x86_64 distribution
  - VST3 or CLAP compatible DAW
  (AU and AAX are not available on Linux)

------------------------------------------------------------------------
Installation
------------------------------------------------------------------------

Windows:
  VST3: C:\Program Files\Common Files\VST3\
  CLAP: C:\Program Files\Common Files\CLAP\
  AAX:  C:\Program Files\Common Files\Avid\Audio\Plug-Ins\

macOS:
  VST3: /Library/Audio/Plug-Ins/VST3/
  AU:   /Library/Audio/Plug-Ins/Components/
  CLAP: /Library/Audio/Plug-Ins/CLAP/
  AAX:  /Library/Application Support/Avid/Audio/Plug-Ins/

Linux:
  Run the bundled installer from the extracted tarball:

    ./install.sh              (installs for the current user)
    sudo ./install.sh --system   (installs system-wide)

  To uninstall, add --uninstall (plus --system if you installed
  system-wide).

  Or copy the plugins manually:

    Per-user:      YouAreNotCrazy.vst3  ->  ~/.vst3/
                   YouAreNotCrazy.clap  ->  ~/.clap/

    System-wide:   YouAreNotCrazy.vst3  ->  /usr/lib/vst3/
                   YouAreNotCrazy.clap  ->  /usr/lib/clap/

After installing, rescan for plugins in your DAW.

------------------------------------------------------------------------
Where your settings are stored
------------------------------------------------------------------------

Saved capture slots are stored per machine, so they follow you into
every project:

  Windows:  %APPDATA%\BruceJames\YouAreNotCrazy\captures.json
  macOS:    ~/Library/Application Support/BruceJames/YouAreNotCrazy/captures.json
  Linux:    ~/.config/BruceJames/YouAreNotCrazy/captures.json

------------------------------------------------------------------------
Support
------------------------------------------------------------------------

support@brucejames.studio
https://brucejames.studio
